home *** CD-ROM | disk | FTP | other *** search
/ GIFs Galore 1993 September / Walnut Creek GIFs Galore CDROM WIN-MAC (Walnut Creek CDROM)(September 1993).iso / pc / viewers / msdos / bld2gif.arc / BLD2GIF.DOC < prev    next >
Text File  |  1988-05-23  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.               BLD2GIF (c) 1988 Lawrence Gozum & Marvin Gozum
  7.               ──────────────────────────────────────────────
  8.  
  9.                                 User Manual
  10.  
  11.     DISCLAIMER
  12.  
  13.     This  product  is distributed AS IS.  The authors specifically disclaim
  14.     all  warranties  ,expressed  or implied, including ,but not limited to,
  15.     implied  warranties  of  merchantability  and  fitness for a particular
  16.     purpose  with respect to defects in the diskette and documentation, and
  17.     program  license  granted  herein,  in particular, and without limiting
  18.     operation  of  the  program  license  with  respect  to  any particular
  19.     application  use  or  purpose.  In no event shall the authors be liable
  20.     for  any  loss  of  profit or any other commercial damage including but
  21.     not limited to special,incidental, consequential or other damages.  
  22.  
  23.  
  24.     LICENSING AGREEMENT
  25.  
  26.     You  may  use  this program on a TRIAL BASIS only;  this means that you
  27.     may  freely  evaluate  the  usefulness of this program for a reasonable
  28.     period.    Should  you  find  this program useful, you must register it
  29.     (see  last  section  of  this manual).   You will then be provided with
  30.     the  latest release of VGACAD (VGA Computer Assisted Design) and latest
  31.     updates of all released utilities.
  32.  
  33.     You  may  freely  distribute  copies  of this program in its UNMODIFIED
  34.     state  provided  you do not include it in other software packages, with
  35.     the  exception  of distributing it as part of a bundle of Public Domain
  36.     or  shareware  programs  on a single diskette.  In addition you may not
  37.     charge  more that $3.50 for copying and/or distributing this program in
  38.     the absence of any recognized Users Group guidelines.
  39.  
  40.  
  41.     WHAT IS BLD2GIF ?
  42.  
  43.     BLD2GIF  is  a  conversion  utility  for  creating  files  which follow
  44.     CompuServe's  GIF  ("Graphics  Interchange  Format").    GIF  files are
  45.     "universal"  in  that  it  allows  the  transmittal and porting of your
  46.     pictures  to  other machines as well as through communication software.
  47.     Pictures  in  the  GIF format can be viewed in different graphics modes
  48.     and  machines depending on the sophistication of the software.  BLD2GIF
  49.     will  convert  any screen captured with VGACAP or any screen created on
  50.     VGACAD;    in  effect  you  can convert ANY viewable picture into a GIF
  51.     picture.    All  screens captured by VGACAP can be edited, garnished or
  52.     image processed with VGACAD.
  53.  
  54.  
  55.     WHAT IS VGACAP ?
  56.  
  57.     VGACAP  is  a  terminate-stay-resident (TSR) utility that allows you to
  58.     capture  the 256 color palette and screen in the 320x200x256 color mode
  59.     and  save both the palette and screen in "Bloadable" formats.  VGACAP's
  60.     main  purpose  is to capture and "Bsave" the pictures of commercial and
  61.     shareware  viewing  programs  as  well  as  painting/graphics  and  CAD
  62.     programs available now and in the future.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.     VGACAD  (one  of  the  first  256  color  paint/CAD  shareware programs
  73.     distributed  in  the  Public domain) will load the captured screens and
  74.     palettes,  as  soon as you rename the files to follow the .plt and .bld
  75.     extensions.
  76.  
  77.  
  78.     REQUIREMENTS
  79.  
  80.     You  MUST have a VGA or MCGA adaptor (at least BIOS compatible) present
  81.     and  an  analog  monitor  to  use VGACAP and BLD2GIF.  VGACAP uses less
  82.     than  2K  of  your  available  memory  !   BLD2GIF needs about 192KB of
  83.     diskspace and free memory to run succesfully.
  84.  
  85.     Note:    When  in  DOS  or  using  a  picture  viewer (e.g., VGAGIF) or
  86.     application  which  requires a keypress to continue, it is necessary to
  87.     hit  any  key  or  a  specified  key  (e.g.,  spacebar or return) after
  88.     hitting the 'HOTKEY' before VGACAP saves the screen and palette.
  89.  
  90.  
  91.     HOW TO USE VGACAP
  92.  
  93.     Simply  run  VGACAP  before  entering  your  painting/CAD  or digitized
  94.     picture  viewer.    After loading,  press <ALT-F10>, while viewing your
  95.     picture  in  any  drawing/paint/CAD  or  viewing  program. Your current
  96.     screen  and  palette  will be saved in your default drive and directory
  97.     in the standard Bsave format for all BASIC programs.
  98.  
  99.     The  first  time  you  run  the  program  it  will save your screen and
  100.     palette  to  MCAGSCRN.000  and MCGAPLET.000 respectively.  It will then
  101.     increase  both  extensions  up  to  .999.    If  there  is  an existing
  102.     MCGASCRN.xxx  or  MCGAPLET.xxx file, then it will increment to the next
  103.     higher  number.    This can be confusing if you keep the captured files
  104.     without  renaming  them  since  you  can  have  unmatched  screens  and
  105.     palettes.    You  can  use your favorite memory managers to remove this
  106.     TSR or reboot to release it from memory.
  107.  
  108.  
  109.     HOW TO USE BLD2GIF
  110.  
  111.     Every  captured  picture  or  picture created with VGACAD will have two
  112.     files:  the  screen  and palette.  The screen should have the extension
  113.     .BLD and .PLT for the palette.
  114.  
  115.          a)   WITH captured screens and palettes using VGACAP
  116.  
  117.               If  your  picture was captured with VGACAP, rename both files
  118.               with  the  same  name with the corresponding extensions.  For
  119.               example  rename MCGASCRN.000 to MYPIC.BLD and MCGAPLET.000 to
  120.               MYPIC.PLT.
  121.  
  122.               e.g. while in DOS type "rename MCGASCRN.000 MYPIC.BLD"
  123.  
  124.          b)   WITH created/edited screens palettes using VGACAD
  125.  
  126.               In  VGACAD you have the flexibility of using a single palette
  127.               for  several  pictures.  If your screen was named "MYPIC.BLD"
  128.               and  you  used  "GRAY64.PLT"  for  the screen, then rename or
  129.               copy "GRAY64.PLT" to "MYPIC.PLT" file.
  130.  
  131.               e.g. while in DOS type "copy GRAY64.PLT MYPIC.PLT"
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.          c)   WITH BASIC Bsaved pictures using hardware palette
  139.  
  140.               In  BASIC, when you invoke SCREEN 13 the VGA card defaults to
  141.               a  standard  hardware  palette.    You  can BSAVE you screens
  142.               using the following lines:
  143.  
  144.               Screen 13:                 'init MCGA 256 color mode
  145.               DEF SEG=&HA000:            'point data segment to
  146.                                          'screen buffer A0000H 
  147.               BSAVE"MCPIC.BLD",0,64000:  'bsave the screen
  148.               DEF SEG:                   'restore data segment
  149.  
  150.               Copy  and  rename the included file "BASIC.plt" to match your
  151.               bsaved picture.
  152.  
  153.               e.g. while in DOS type "copy BASIC.PLT MYPIC.PLT"
  154.  
  155.               If  you  are  directly  making pictures from BASIC, I suggest
  156.               using  VGACAP  to  save screen and palette changes instead of
  157.               being  limited  by  the  standard  hardware palette.  BASIC's
  158.               PALETTE  USING  does  not support reading (much more a way to
  159.               bsave) palettes in a BIOS compatible format.
  160.  
  161.     Now  that you have the screen and palette type "BLD2GIF MYPIC <return>"
  162.     then  after  a  few seconds, you picture and palette will be merged and
  163.     converted  to  MYPIC.GIF.    This  picture  can  now be viewed with GIF
  164.     viewers  (e.g.,  Michael  Vigneau's  VGAGIF)  or used with any software
  165.     that supports GIF pictures.
  166.  
  167.  
  168.     BLOADING captured screens in BASIC
  169.  
  170.     The  following  lines  will  load  one  of  the  captured  screens from
  171.     QuickBASIC 4.0
  172.  
  173.     If  you  are  using  QuickBASIC  1.0,  2.0  or  3.0,  I  have  included
  174.     VGAMODE.obj   which   you  can  include  in  your  UserLib.exe  through
  175.     BUILDLIB.exe.  
  176.  
  177.     VGAMODE  is  a BIOS compatible assembly routine which can call the more
  178.     exotic  graphic  modes  of  your  compatible  VGA card (e.g. 800x560x16
  179.     color  mode  of  ATI's  VGA VIP and EGA Wonder); check your user manual
  180.     for the correct hex codes.
  181.  
  182.  
  183.          USAGE:  Call VGAMODE(&H13) :    'MCGA 256 color mode
  184.          or      Call VGAMODE(mode%):    'where mode is an integer that
  185.                                          'corresponds to the videomode
  186.                                          'after translating it from HEX
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.     The following lines will perform just as well as the listing above.
  205.  
  206.  
  207.     Call VGAMODE(&H13):                  'init MCGA 256 color mode
  208.     DEF SEG=&HA000:                      'point data segment to
  209.                                          'screen buffer A0000H 
  210.     Bload "MCGASCRN.000",0:              'load the screen
  211.     DEF SEG   :                          'restore data segment
  212.  
  213.  
  214.     As  a  matter  of  convention,    if  you are using VGACAD,  you should
  215.     rename  your capture screens with the .BLD extension (e.g., MYPICT.BLD)
  216.     for use in VGACAD or conversion in BLD2GIF.
  217.  
  218.  
  219.     BLOADING captured palettes in BASIC
  220.  
  221.     If  you  are  using  QuickBASIC  (any  version from 1.0 to 4.0), I have
  222.     included  WRITEPAL.obj,  which  is, also a VGA BIOS routines written in
  223.     assembly,   that   you   can   include   in  your  UserLib.exe  through
  224.     BUILDLIB.exe (v3.0 and lower) or LINK (v4.0).
  225.  
  226.     WRITEPAL  is also a BIOS compatible assembly routine that writes to 256
  227.     palette  registers.    Although  its  main purpose is to facilitate the
  228.     overriding  of  the  VGA  or  MCGA  standard  palette,  since  it is an
  229.     all-purpose  BIOS  routine  it will facilitate changing the palettes of
  230.     more  exotic  screen  modes  such  as  the 640x480x256 color screens of
  231.     IBM's  8514/A  adaptor.  This function is similar to "PALETTE USING" in
  232.     QuickBASIC  with  the  major advantage of following the BIOS convention
  233.     which VGACAP captures and bsaves.
  234.  
  235.          USAGE:  Call WritePal (Dseg%,Offset%)
  236.  
  237.          WHERE:  Dseg%  =result of VARSEG for array storage
  238.                  Offset%=result of VARPTR for array storage
  239.  
  240.     The following lines illustrate its use.
  241.  
  242.          REM: Example Routine
  243.          DIM UserPal%(769)               :' 256 colors x 3 registers=768
  244.                                          :' registers= red grn blu
  245.          Dseg%=VARSEG(UserPal(1))        :' get data segment
  246.          Offset%=VARPTR(UserPal(1))      :' get offset
  247.          DEF SEG=Dseg%                   :' override data segment
  248.          BLOAD "MCGAPLET.000",Offset%    :' bload in correct offset
  249.          DEF SEG                         ;' restore data segment
  250.          Call WritePal (Dseg%,Offset%)
  251.  
  252.  
  253.     Palettes  captured by VGACAP follow the BIOS calling convention in that
  254.     they  are  contiguous  RGB  (red green blue) values for all 256 colors.
  255.     Not  only  is this the same way GIF stores the palette in its file, but
  256.     one  BIOS  call  can update an entire palette with RGB values stored in
  257.     this manner.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.     USING VGABLD
  271.  
  272.     The  "bloadable" format has several advantages over GIF.  If you intend
  273.     to  use  your  pictures  primarily  in IBM machines in VGA or MCGA mode
  274.     then   you  will  notice  that  the  pictures  load  INSTANTANEOUSLY  !
  275.     Bloading  a  screen  is  simply  a  memory dump into your display area;
  276.     this is particularly crucial for presentations.
  277.  
  278.     In  addition, keeping the screen and palette separate allows you to use
  279.     one  palette for several pictures or for creating special effects.  For
  280.     example,  you  can  make a picture shift from a "day scene" to a "night
  281.     scene"  by  simply  changing the palette; you can also create animation
  282.     effects.
  283.  
  284.     You  need not go through the tedium of writing your own program just to
  285.     view  your  captured pictures.  VGABLD will load a picture for viewing.
  286.     Captured  screen  and  palette  MUST  have the .BLD and .PLT extensions
  287.     respectively  for  the same picture.  The BASIC source code is included
  288.     and is ready for compilation.
  289.  
  290.  
  291.     REGISTRATION
  292.  
  293.     To  register  your  copy,  send  in the registration form and check for
  294.     $14.95 or $19.95 payable to
  295.  
  296.                              Dr. Marvin Gozum
  297.                       2 Independence Place Apt. 303-2
  298.                             6th & Locust Street
  299.                           Philadelphia, PA 19106
  300.  
  301.     For  $14.95 you will be entitled to the latest update of VGACAD without
  302.     reminders  which  pop-up  every  20  minutes  AND the latest updates of
  303.     released  utilities:    VGACAP,  BLD2GIF  and  CGA2VGA  (converts  your
  304.     library of CGA pictures to VGA 256 color format).
  305.  
  306.     For  $19.95  you  will  be  entitled to the next TWO (2) updates of the
  307.     latest  of everything; this means that from the date of receipt of your
  308.     registration  we will send you the latest version of VGACAD and all the
  309.     related  utilities  developed  and  a  premier  copy of any new utility
  310.     developed  as  well  as the next releases of all the aforementioned and
  311.     any new fonts (with the font editor) and Clipart files when available.
  312.  
  313.     You  can  expect  spectacular  enhancements  in  VGACAD's  updates.  At
  314.     present  it has sophisticated image processing functions, auto/variable
  315.     sizing  and  stretching, image colorization , Cut&Paste, 23 brushes and
  316.     more.   Future updates will include 3D and 2D transformations, gradient
  317.     fills  and  patterns,  and  more;  many of these routines are in "C" or
  318.     assembly and work very fast.
  319.  
  320.     In  the  pipeline  is  QBVGA an extensive library of QuickBASIC VGA 256
  321.     color  graphics  routines,  VGASHW  (a graphics presentation program to
  322.     showoff  your  captured  pictures  or  your  own  paintings  and screen
  323.     design,  EGA2VGA  (a  TSR  to  convert  EGA  screens  to  VGA 256 color
  324.     format),  VGA3DM  (3D  object/model  editor  for  including  models  in
  325.     VGACAD),  and  VGAPRN  (a  print  utility  for EPSON and IBM dot matrix
  326.     printers).    If  you  continue to support maverick authors like us, we
  327.     will  continue  to  develop  these  products  like nothing ever seen in
  328.     commercial   packages  -  otherwise  it  will,  as  many  (sigh!)  good
  329.     "shareware"  packages  have to go commercial or simply die from lack of
  330.     support.   Support us and we'll keep developing.
  331.                                                                            
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.